home *** CD-ROM | disk | FTP | other *** search
/ CICA 1993 April / CICA MS Windows - April 1993.iso / unzipped / sounds / tg100drv / readme.doc < prev    next >
Text File  |  1992-10-21  |  5KB  |  109 lines
  1. Yamaha TG100
  2. Serial Device Driver
  3. Version 1.0
  4.  
  5. Overview:
  6. ---------
  7. The Yamaha Serial Device Driver allows Windows 3.1 users to attach the 
  8. Yamaha TG100 to their computer's serial port.  Follow the direction in the 
  9. manual concerning cabling and the appropriate switch setting on the rear panel.
  10.  
  11. Note:
  12. -----
  13. This device driver is only compatible with Windows 3.1.
  14.  
  15. Hardware Installation:
  16. ---------------------
  17. Connect the TG100 to the computer using the cable recommended in the 
  18. Reference Manual and set the switch on the back of the TG100 as described
  19. in the Reference Manual.
  20.  
  21. Note that the driver will not load if the TG100 is not connected to the
  22. specified COM port and/or is not powered on when Windows loads.  The driver
  23. verifies the existence of the TG100 before fully initializing.
  24.  
  25. Standard mode users should also be aware that due to the way the Windows 
  26. COM drivers are written, it is impossible to place the TG100 on a shared 
  27. interrupt port.  In ISA bus machines, if there are more than two COM ports,
  28. ports 1 and 3 share interrupt 4 and ports 2 and 4 share interrupt 3.  On MCA 
  29. machines, port 1 uses interrupt 4 and all other ports share interrupt 3.
  30. On EISA machines either sharing scheme is possible depending on the type
  31. of COM boards used.
  32.  
  33. Therefore, standard mode users should set the TG100 on COM port 1 to assure 
  34. compatibility and, on ISA or some EISA machines (depending on the type of 
  35. COM board) disable COM port 3.
  36.  
  37. Software Installation:
  38. ---------------------
  39. To install the device driver, simply bring up the Windows Control Panel 
  40. application (typically found in Main group) and select the Drivers icon.
  41. Press the Add button and select the Unlisted or Updated Driver entry from
  42. the list box and press OK.  Respond to Windows prompt concerning the location
  43. of the driver and press OK.  The driver will then display a list of COM ports
  44. available for the TG100.  Select the appropriate COM port and press OK.
  45. Windows will then ask if you wish to restart Windows.  You must restart
  46. Windows for the installation to be completed.
  47.  
  48. If you install the driver while running in Standard mode on a 386 and later
  49. want to run in Enhanced mode, it will be necessary to re-install the driver
  50. to cause Windows to load the 386 driver files.  If you install the driver in
  51. Enhanced mode first and later want to run in Standard mode no actions are
  52. necessary:  Windows will have already loaded all of the necessary files.
  53.  
  54. Enhanced versus Standard Mode:
  55. ------------------------------
  56. This driver is capable of support Windows running in both Enhanced mode and 
  57. Standard mode.  The Standard mode capability is primarily provided for users
  58. of 80286 based systems and/or users that have applications that only run in 
  59. Standard mode.
  60.  
  61. This driver has been tested in Standard mode on 80286 machines with clock 
  62. speeds starting at 12MHz and in Enhanced Mode on 80386SX machines with 
  63. clock speeds starting at 16 MHz.
  64.  
  65. SYSTEM.INI Settings:
  66. --------------------
  67. The following values can be defined under the [TG100.DRV] section of your 
  68. SYSTEM.INI file:
  69.  
  70. [SysExWait=nn]
  71. Because of the interrupt latency in Windows, it is impossible for slow
  72. machines to keep up with a SysEx dump a byte at a time.  For this reason,
  73. when the device driver recognizes that the TG100 is sending a SysEx dump, it
  74. will hold on to the COM port until the completion of all pieces of a SysEx
  75. dump.  Upon recognizing the completion of the SysEx dump the driver will pass
  76. the SysEx data to the MIDI application.  Note that the entire SysEx dump must
  77. first be received  by the driver before data is passed to the MIDI
  78. application.
  79.  
  80. By default the device driver will wait 40 milliseconds to determine that a
  81. SysEx dump is complete.  If no more data is received in this time interval
  82. the data received will then be forwarded to the MIDI application.
  83.  
  84. You can change this interval by setting the SysExWait setting in the 
  85. TG100.DRV section of the SYSTEM.INI file.  The value given is in 
  86. milliseconds: i.e. SysExWait=100 would cause the driver to wait 100 
  87. milliseconds instead of the default 40 milliseconds.
  88.  
  89. Users should consider adjusting this value if they are having problems 
  90. getting complete SysEx dumps.
  91.  
  92. [COMPort=n]
  93. This specifies which COM port the TG100 is attached to and must appear 
  94. in the TG100.DRV section of the SYSTEM.INI file.
  95.  
  96. [BufferSize=nnnn]
  97. This specifies the number of bytes that should be made available to handling 
  98. SysEx dumps.  This can be any value from 1 to 65535: the default value is 
  99. 10240.
  100.  
  101. Users should consider adjusting this value if they plan on receiving large
  102. SysEx dumps from MIDI devices attached to the TG100.
  103.  
  104. [MIDIINPersistence=nn]
  105. This specifies the number of bytes the driver will read from the TG100 before 
  106. returning control to Windows (except in the case of SysEx dumps with are read 
  107. until the dump time interval specified by the SysExWait expires).  The default 
  108. value is 50 which should be adequate for most installations.
  109.